home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 36 / dvscrip1.zip / DVSCRIP.DOC next >
Text File  |  1990-10-15  |  11KB  |  217 lines

  1.  
  2.  
  3.                      DV Scrip{t}!  by Michael D. Weaver
  4.  
  5.  
  6. What is this?
  7.  
  8.   DV Scrip{t}! is a small system of DESQview scripts designed to simplify
  9. the use of DESQview's CONVSCR program and the unique requirements of
  10. producing script statements within a DOS text editor.
  11.  
  12.  
  13. Why use scripts?
  14.  
  15.   Aside from its multitasking prowess, DESQview's most powerful feature is
  16. probably its keystroke recording and playback capability.  Through the use
  17. of scripts, sequences of keystrokes may be 'remembered' to allow repititious
  18. tasks to be performed quickly and easily, but in addition to keystroke
  19. recording, DESQview scripts may also be programmed with delays, to pause for
  20. user input, and to learn and remember other scripts.
  21.   For complete information on DESQview scripts, refer to the appropriate
  22. sections of your DESQview manual.
  23.  
  24.  
  25. Why edit or create scripts manually?
  26.  
  27.   For one thing, some scripts can't be created any other way.  Let's assume
  28. you want to create a script to quit DESQview.  The needed keys are:  {DESQ}QY.
  29. DESQview will let you try to 'Learn' these keys, but they'll never be saved
  30. because by the time you're done, DV will have ended execution!  Another
  31. simple example would be a script that closes the current window, then opens
  32. another in it's place:  {DESQ}CY{DESQ}Oxx (where 'xx' are the open keys of
  33. the window to open).  These examples, and many other possibilities like them
  34. can only be created manually.
  35.   Without manual editing capabilities, modifying existing scripts can pose
  36. annoying problems.  It's possible to create long, complicated, but very useful
  37. scripts using the LEARN feature; the problem comes when they need to be
  38. changed, for example:  Assume you've created a long script with a timed delay
  39. that just isn't long enough when the system is churning away on some monstrous
  40. spreadsheet in the background.  The goal is to increase the time of the delay,
  41. but if you have to use LEARN to do it, every keystroke and other feature of
  42. the script must be duplicated exactly, and all over again.  Needless to say,
  43. if you've got a hundred or more keystrokes to enter in perfect order, you're
  44. in for frustration.  DESQview's solution to this problem is called CONVSCR.
  45.  
  46.  
  47.  
  48. What exactly is CONVSCR?
  49.  
  50.   CONVSCR is a program supplied with DESQview whose purpose is to translate
  51. DESQview scripts from their native form (?.DVS) to text that may be
  52. understood and vice versa.  The program performs these tasks quite well, but
  53. is a general pain in the *.* to use; it takes no command line input, thus
  54. resisting batch file execution, and it demands that the user key complete
  55. input/output filenames, even though 99% of the time the names are identical
  56. with the exception of the standard file extensions .DVS and .TXT.  Hence,
  57. regardless of its useful functions, it's the sort of program people tend to
  58. avoid using.  The first purpose of DV Scrip{t}! is to ease access to the
  59. functions of CONVSCR.
  60.  
  61.  
  62. So what's the second purpose of DV Scrip{t}!?
  63.  
  64.   Well, I'm glad you asked!  The fact is that CONVSCR is a script converter,
  65. and not at all an editor.  Let's say you convert DESQVIEW.DVS to a text
  66. file called DESQVIEW.TXT.  Now you must use an editor to change the latter
  67. file before again using CONVSCR to turn it back into a useful script file.
  68. After loading DESQVIEW.TXT into an editor, you'll see a lot of key names
  69. and other stuff squished between curly-brackets - these are the actual
  70. commands of DESQview's script language, documented (mostly accurately)
  71. somewhere near the end of your DESQview manual.  If you're like me, you
  72. rarely have your manuals close at hand, and even if you do, you'd rather
  73. not have to pick them up....  So the second purpose of DV Scrip{t}! is to
  74. provide a quick and convenient way of entering script commands into your
  75. text editor.
  76.  
  77.  
  78. Okay, so how do I get started?
  79.  
  80.   Simple (ahem!).  The other files in this distribution archive (excluding
  81. this one), need to be copied to your \DV directory (or wherever you start
  82. DESQview from).  There should be a PIF file included called SX-PIF.DVP -
  83. Use DESQview's ADD A PROGRAM to add this PIF to your system.  It's really
  84. nothing more than a DOS window for you to run your text editor in; it's
  85. main purpose is to give you a window that loads SX-SCRIP.DVS by default.
  86. If ADD A PROGRAM says you've already got SX defined, then pick any set of
  87. keys that suit you, but remember to change the SX in SX-SCRIP.DVS to the
  88. same set of keys--->*** You will also have to edit SX-SCRIP.DVS in the
  89. SCRIPTED.DVS file (many times) later on - if this sounds daunting to you
  90. the easiest solution is to assign your current SX program to a different
  91. set of Open Keys.
  92.   Note:  The most important parameter in the PIF for SX is the large
  93. script buffer (almost 12K).  All other parameters may be modified to suit
  94. your taste and/or that of your text editor.
  95.   Once you have the SX window or suitable substitute installed in your
  96. DESQview system, open the window and press Alt-1.  If all has gone well,
  97. you should see the Display Scripts menu with 8 entries.  Now we'll get
  98. some useful practice....  Select the third script down (Edit XX-scrip);
  99. the script should execute CONVSCR and pause, waiting for you to key in
  100. two keys representing a set of open keys, then press enter.  Key in SX,
  101. and press enter.
  102.  
  103.  
  104.   The script we are running here is setup to go straight into my text
  105. editor, which is my DOS PATH and called simply Q.  If your editor has the
  106. same name, you're lucky, but otherwise you should see something like:
  107.  
  108. C:\DV>q sx-scrip.txt
  109. Bad command or filename
  110.  
  111.   If this happened, load sx-scrip.txt into the editor of your choosing, and
  112. look for lines in the file like:
  113.  
  114. q {255}.......{Enter}
  115.  
  116.   These lines are where my editor is being executed (there should be three
  117. of them).  Replace the Q's with the name of your editor, and update the
  118. file.  Now it's time to save your changes:  Exit your editor and get back
  119. to the DOS prompt.  Hit Alt-1 to get the menu, and select the script titled
  120. XX-scrip.txt-DVS.  Again we go through CONVSCR....  Key SX and enter at the
  121. prompt, and CONVSCR will scroll your txt file across the screen until it's
  122. munched it or gotten an error (the bugger will pause at the line(s) in
  123. question in the latter case).  Now reload the scripts (Shift-DESQ,L,enter -
  124. or you can try the lazy man's way of closing and reopening the window...)
  125. Try starting one of the edit scripts again - if all has gone well you should
  126. end up with the .TXT file in your editor.  To summarize thus far:
  127.  
  128. In the SX window, Alt-1 reveals the Display Scripts menu on which there are
  129. scripts designed to run CONVSCR, three in each direction.  One pair lets
  130. you convert/edit XX-SCRIP.DVS files (standard names, each associated with
  131. Open Window keys), another pair lets you edit/convert DESQVIEW.DVS (the
  132. scripts that are active when the DESQ menu is up), and the third pair
  133. is for something called SCRIPTED.DVS (you probably won't need this pair unless
  134. you'd like to change something I've done.)  These scripts need not be executed
  135. from the menu.  They are assigned to various keypad keys, and you may
  136. freely reassign them - the most important thing is that they don't conflict
  137. with keys you need to use inside your editor.  They should only be run when
  138. you're at a clear DOS prompt.
  139.  
  140.   The last (and nastiest) script to discuss is Load SCRIPTED.DVS, located
  141. on Alt-`, conveniently next to the Alt-1 key.  This script is designed for
  142. use within your editor:  When you need to enter a script command of any
  143. kind, hit Alt-`.  The next key you hit will cause the associated script
  144. command to be written into your editor, i.e., if you hit Shift-F10, you will
  145. see {Shift-F10}.  To enter other script commands such as delays and variable
  146. pauses, hit Alt-` followed by Alt-1 (again you get a menu....)  Among the
  147. first scripts listed are all the various 'special' script commands - to
  148. put these into your script, select with the cursor bar and hit enter.
  149.  
  150.  
  151.  
  152.   With SCRIPTED.DVS active, all possible script keys, with the exceptions
  153. of Alt-` and Alt-1, should write their script command counterparts.  For
  154. obvious reasons (I hope), the two exceptions are needed for this system
  155. to work.
  156.  
  157.   A final but important comment:  SCRIPTED.DVS is dependent on the
  158. ` character (top left corner of keyboard) being DESQview's 'quoting
  159. charater for LEARN'.  This is part of the DV Advanced Setup - if you've
  160. changed this character, then you must also change all occurences of it in
  161. SCRIPTED.DVS.  Better yet, put it back the way it was (to `) unless you're
  162. positive you have another program that really needs it.
  163.  
  164.  
  165.  
  166. So now what?
  167.  
  168.   Haven't I simple-Simon'd you to tears already?  That's all the basics,
  169. the best thing I can tell you now is practive with it and get comfortable
  170. with the Alt-1, Alt-` combos.  However, please read on:
  171.  
  172.  
  173. >>>>>>> DESQview is a trademark of Quarterdeck Office Systems.  I am not
  174. associated with Quarterdeck Office Systems in any way.  But:
  175.  
  176.         The contents of this archive are (c)1990 Michael D. Weaver.  If you
  177. find the scripts useful, a contribution in any amount would be appreciated,
  178. but is in no way required for continuing use.  You may freely modify and
  179. enhance these scripts however you see fit, and this archive (in unmodified
  180. form) may be distributed freely through bulletin board systems and other
  181. means as long as no fee greater than $5 is charged the recipient.  In any
  182. case, I can accept no personal responsibility for the correct functioning of
  183. these scripts on any system but my own.
  184.         I am also the author of various shareware programs designed to work
  185. specifically (and only with) Quarterdeck Office Systems' DESQview. At the
  186. time of this writing, these programs include DV Tree, a file manager/shell
  187. with several unique DV-specific functions, and DV Task Manager, an event
  188. automation program to allow the unattended operation of 'on-line' DESQview
  189. systems.  These programs are distributed as DVTREEnn.ZIP and DVTMANnn.ZIP,
  190. where nn indicated the version/release numbers, and both programs (at the
  191. time of this writing) carry a $25 registration fee.
  192.         For a $10 'hassle' fee mailed to the below address, you will
  193. receive a 3.5" 720k diskette containing the latest release of this archive
  194. (which will probably still be DVSCRIP1), accompanied by the latest
  195. shareware (unregistered) versions of the programs mentioned above and any
  196. others I may have since written.  Alternately, you should be able to locate
  197. the latest versions of all my programming efforts on the following BBS's:
  198.  
  199.   *******                                                          *********
  200.   *******  JFF (Just For Fun)      Danville, VA   (804)793-6094    *********
  201.   *******  VOR (Home of LIST)      Petaluma, CA   (707)778-8944    *********
  202.   *******  Quarterdeck BBS     Santa Monica, CA   (213)396-3904    *********
  203.   *******                                                          *********
  204.  
  205. That, finally, is ALL!  Happy Scrip{t}ing!
  206.  
  207.     Michael D. Weaver
  208.     Box 4323
  209.         Danville, VA   24540-0106
  210.  
  211.     Electronic contact addresses:
  212.  
  213.         MCI Mail        (MWEAVER)
  214.     FidoNET        (Mike Weaver - 1:264/610)
  215.         CIS             (72210,2035)
  216.  
  217.